home *** CD-ROM | disk | FTP | other *** search
/ 2,000 Greater & Lesser Mysteries / 2,000 Greater and Lesser Mysteries.iso / internet / mys01124.txt < prev    next >
Encoding:
Internet Message Format  |  1994-06-10  |  7.6 KB
  1. From: jds@math.okstate.edu (Jennifer "Moira" Smith)
  2. Date: 16 Jul 93 06:00:36 GMT
  3. Newsgroups: rec.games.mud.announce,rec.games.mud.misc,news.answers,rec.answers
  4. Subject: [rec.games.mud]: FAQ #3/3: RWHO and "mudwho"
  5.  
  6. Archive-name: games/mud-faq/part3
  7. Version: $Id: faq.rwho,v 3.0 93/06/14 16:19:13 jds Exp $
  8.  
  9. FREQUENTLY ASKED QUESTIONS: Basic Information on RWHO and "mudwho"
  10.  
  11. This is part 3 in a 3 part series of FAQs.
  12.  
  13.  
  14. Table of Contents
  15. -----------------
  16.         1. What is RWHO?
  17.         2. How Does It All Work?
  18.         3. Where Can I Get This Stuff?
  19.         4. Where Are Some RWHO Servers?
  20.  
  21.  
  22.  
  23. 1. What is RWHO?
  24.  
  25.   RWHO stands for 'Remote WHO'.  It's a way of getting a WHO list from
  26.   a MUD, without even having to connect to that MUD at all.  Anyone
  27.   can get this output from a RWHO server (an 'mwhod'), by using straight
  28.   telnet to connect to a certain port (6889), or by using the client program
  29.   'mudwho'.  RWHO servers talk to other mwhods, passing information around,
  30.   and are talked to directly by some MUDs, receiving information from them. 
  31.   Any one mwhod keeps track of several MUDs, plus storing information passed
  32.   it from other mwhods.  Only MUDs that have the RWHO routines compiled in
  33.   will be able to send their WHO list info to a mwhod.  UnterMUDs have this
  34.   capability built in; other MUDs have to have the routines installed first.
  35.   The RWHO routines have been installed into TinyMUSH, TinyMUCK, LPMUD,
  36.   DikuMUD, and AberMUD, without encountering any difficulty.
  37.  
  38. 2. How Does It All Work?
  39.  
  40.   'mwhod' is the RWHO server that runs on a particular host and
  41.   keeps a list of known MUDs. It is initially primed with a list of "trusted"
  42.   MUDs and passwords used for authentication, and will accept information
  43.   about who is logged into those MUDs. The server also has a notion of
  44.   a "peer" server, which can transfer it (occasionally) a copy of all of
  45.   its list of who is logged on, and where. The idea is that the whole
  46.   MUDding community could probably be served pretty well by about 5 peer
  47.   mwhods that kept each other up to date about what each one is seeing.
  48.   
  49.   Communication between mwhods (and server updates sent to mwhods)
  50.   is done with UDP datagrams, since they're fast, nonblocking, and
  51.   throw-away. (RWHO information is considered to be interesting but not
  52.   vital information, if you get my drift). Each MUD server only sends
  53.   updates to a single mwhod, which may then propagate that information
  54.   to its peers. This is done within the MUD server as follows:
  55.   
  56.         - whenever the server boots, it sends a "hi there" packet to
  57.          the mwhod, telling it that it's up and running.
  58.         - whenever a player connects, it sends a "so and so is here"
  59.          packet to the mwhod, telling it that the user has connected.
  60.         - whenever a player disconnects, it sends a "so and so left"
  61.          packet to the mwhod, telling it to delete the entry.
  62.         - every so often ("so often" being defined as a time agreed
  63.          upon by the mwhod's owner, and the MUD's wizard, usually
  64.          every 5 minutes or so) the MUD sends a "hi there" packet
  65.          and a complete list of everyone that is on, just to refresh
  66.          the mwhod's idea of who is logged into that MUD.
  67.  
  68.   If a user connects to a specific port (6889) of a host machine
  69.   running an mwhod they are given a formatted dump of the mwhod's current
  70.   table of MUDs and players, and then disconnected. "mudwho" is a simple
  71.   little program that contacts an mwhod and downloads this information. 
  72.   Ideally, the functionality of "mudwho" would be built into a player's
  73.   client software, for ease of use. Two handy options can be used by 
  74.   "mudwho", if the netlag to the mwhod server isn't too bad. The options
  75.   are "-u <username>", and "-m <mudname>". If received before the timeout,
  76.   the mwhod will then only dump WHO list information for the specified
  77.   player or MUD.
  78.  
  79.   The mwhod does some clever stuff as far as eventually timing
  80.   information about of its tables - for example, if it hears absolutely
  81.   nothing from a MUD for a certain amount of time, it will mark the MUD
  82.   as down. Player entries are expired similarly. The design is based on
  83.   the idea that we'll use UDP to just fling information out and hope it
  84.   sticks, and then let the recipient clean it up, rather than to develop
  85.   a more complex protocol based on TCPs and timeouts. To prevent a packet
  86.   circular send situation, each entry that is sent is given a "generation"
  87.   number, which is incremented by one each time it is forwarded along. In
  88.   this manner, a MUD server might send a "so and so is here" (generation
  89.   zero) to its local mwhod. The local mwhod will eventually send a copy to
  90.   any peers it may have (generation one), and so forth. Part of the initial
  91.   table that an mwhod uses to establish what peers it trusts contains a
  92.   generation value, and it will neither accept nor propagate information
  93.   to a specific peer that is of a higher generation value. This way, a
  94.   "tree" of servers could theoretically be constructed, with the highest
  95.   level one having a total view of a large MudIverse.
  96.  
  97. 3. Where Can I Get This Stuff?
  98.  
  99.   The client program "mudwho" can be ftp'd from ftp.math.okstate.edu
  100.   (139.78.10.6), in pub/muds/clients.  The shar file contains both
  101.   mudwho.c and a README file, listing a few mwhod sites.  The plain "mudwho.c"
  102.   file can be found at decuac.dec.com (192.5.214.1).
  103.  
  104.   The RWHO routines can be ftp'd from decuac.dec.com (192.5.214.1),
  105.   in pub/mud.  Included is a HOW_TO file, which describes how to plug
  106.   the routines into a MUD server, and also where to ask for a mwhod to use.
  107.   
  108.   The mwhod program itself can also be found on decuac, but there is
  109.   currently little need for another one running in the USA.  There is, however,
  110.   only one running in Europe, and further expansion may need to be made in
  111.   that area. 
  112.  
  113. 4. Where Are Some RWHO Servers?
  114.  
  115.   Currently, all of these servers talk to each other, so what one knows, 
  116.   the rest will know, with the exception of the mwhod in Germany, which only
  117.   talks to the mwhod on riemann.math.okstate.edu (so only riemann has
  118.   the RWHO information from Europe currently). At any one time, there's an
  119.   average of 20 muds, of various types, talking to mwhods.
  120.  
  121. Site                         IP           Port  Admin
  122. ------------------------------------------------------------------------------
  123. riemann.math.okstate.edu     139.78.1.15  6889  jds@math.okstate.edu
  124. amber.ecst.csuchico.edu      132.241.1.43 6889  warlock@ecst.csuchico.edu
  125. nova.tat.physik
  126.   .uni-tuebingen.de          134.2.62.161 6889  gamesmgr@taurus.tat.physik
  127.                                                 .uni-tuebingen.de
  128.  
  129. ------------------------------------------------------------------------------
  130.   This posting has been generated as a public service.  If you have any
  131.   suggestions, questions, additions, comments or criticisms concerning this
  132.   posting, contact Jennifer Smith, aka Moira (jds@math.okstate.edu).
  133.   Other Frequently Asked Questions (FAQ) postings contain information 
  134.   dealing with MUDs, MUDding, clients, servers, and FTP sites.  While these
  135.   items aren't necessary, they make the game much more playable.  I'd also
  136.   like to thank Marcus J Ranum (mjr@decuac.dec.com) for writing such a 
  137.   wonderful program (and decent docs), and everyone else for helpful comments
  138.   and suggestions. 
  139.   The most recent versions of these FAQs are archived on ftp.math.okstate.edu
  140.   (139.78.10.6) in pub/muds/misc/mud-faq, plus on rtfm.mit.edu(18.170.0.226)
  141.   in the news.answers archives.  Have fun!  - Moira
  142. -- 
  143. Jennifer Smith
  144. jds@math.okstate.edu
  145. On MUDs: Moira, RosaLil, Jasra, etc.          |   It's the terror of knowing
  146. Here, have a clue. Take two, they're small.   |    What this world is about
  147.  
  148.